home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / graphics / gnuplot / README.ins < prev    next >
Text File  |  1993-01-31  |  9KB  |  235 lines
  1. The GNUPLOT source code and executables may be copied and/or modified
  2. freely as long as the copyright messages are left intact.
  3.  
  4. See the History file for changes to GNUPLOT.
  5.  
  6. Compilation instructions are near the end of this file.
  7.  
  8. GNUPLOT has been tested on Sun3's and Sun4's (SunOS 4.0.3 and 4.1.1),
  9. a VAX 6410 (VMS 5.2), Commodore Amiga's (KS/WB 1.3 and 2.0, Lattice C
  10. and Aztec C beta 5.2a), IBM PC XT's and AT's (MS-DOS 3.3/5.0 BC++
  11. 3.1/TC++ 1.0 MSC 7.0), IRIS 4D/70G and 4D/25G with MIPS C, NeXT with
  12. gnu C 1.34, DECStation 5000/200PXG (ULTRIX V4.1), AT&T 3B1 (version
  13. 3.51m with cc and gcc 1.39), and Apollo's (DomainOS SR10.3 BSD4.3
  14. with C compiler 68K Rev 6.7(316)).  The code is written with
  15. portability in mind.  GNUPLOT has not been tested on Pyramid 90x.
  16.  
  17. Send your comments, suggestions, or modifications to
  18.   info-gnuplot@dartmouth.edu
  19. This is a mailing list; to join it send a note to
  20.   info-gnuplot-request@dartmouth.edu
  21. Send bug reports to
  22.   bug-gnuplot@dartmouth.edu
  23.   [Please tell us the version and machine on which your bug occurred.]
  24. You can also post to the Usenet group
  25.   comp.graphics.gnuplot
  26.  
  27.  
  28.                        PREPROCESSOR #DEFINES
  29.  
  30. These #defines should be checked before compilation (see the makefiles):
  31. define      file            note
  32. ------      ----            --------
  33. NOVFORK     Makefile        define if you don't have the vfork() system call
  34. GAMMA       Makefile        define if you've got gamma(3)
  35. MEMCPY      Makefile        define if your bcopy() is called memcpy()
  36. MEMSET      Makefile        define if you have memset() but not bzero()
  37. NOCOPY      Makefile        define if you've don't have a memcpy() by any name
  38. bcopy()     plot.h          define if you've got a memcpy() by some OTHER name
  39.                               (see example in plot.h)
  40. PC          Makefile        define if compiling on a PClone
  41. MSDOS       Makefile        define if compiling under MSDOS;
  42.                               automatically defined by Microsoft C 5.10
  43. HELPFILE    Makefile        name including path of gnuplot.gih file.
  44. VERYLARGE   plot.h          define to be largest coordinate number.
  45. SHELL       plot.h          default shell to spawn if SHELL environment
  46.                               variable not found at run-time
  47. NOCWDRC     Makefile        define to inhibit check of ./.gnuplot
  48. READLINE    Makefile        define if you want command-line editing
  49.  
  50. Valid TERMFLAGS defines.  These defines are used to include the
  51. various plotting terminals, printers, and protocols that a given version
  52. of gnuplot can access:
  53.  
  54. define      file            note
  55. ------      ----            --------
  56. TERMFLAGS   Makefile        the set of terminals you want, from below
  57.             or term.h
  58.  
  59.    AED         AED 512 and AED 767
  60.    AIFM        Adobe Illustrator Format
  61.    AMIGASCREEN Amiga custom screen
  62.    APOLLO      Apollo Graphics Primitive Resource (resizable window)
  63.    ATT6300     PC with AT&T 6300 graphics
  64.    BITGRAPH    BBN BitGraph
  65.    CGI         SCO CGI
  66.    COREL       COREL! Draw Format
  67.    CORONA      PC with Corona graphics 325
  68.    DXY800A     Roland DXY800A plotter
  69.    DUMB        Printer or glass dumb terminal
  70.    DXF         AutoCad (Release 10.x) dxf file format
  71.    EEPIC       EEPIC-extended LaTeX driver, for EEPIC users
  72.    EGALIB      PC with EGA/VGA graphics.
  73.    EMTEX       LaTeX picture environment with emTeX specials
  74.    EPS60       Epson-style 60-dot per inch printers
  75.    EPSONP      Epson LX-800, Star NL-10, NX-1000 and lots of others
  76.    EXCL        Talaris EXCL laser printer format
  77.    FIG         Fig graphics language (requires object.h from TransFig)
  78.    GPR         Apollo Graphics Primitive Resource (fixed-size window)
  79.    HERCULES    IBM PC/Clone with Hercules graphics board
  80.    HP2648      HP2648, HP2647
  81.    HP26        HP2623A and maybe others
  82.    HP500C      HP Deskjet 500 C and maybe other Color Deskjets
  83.    HP75        HP7580, and probably other HPs
  84.    HPGL        HP7475 and (hopefully) lots of others
  85.    HPLJII      HP Laserjet II
  86.    HPPJ        HP PaintJet
  87.    IMAGEN      Imagen laser printers (300dpi) (requires -Iterm also)
  88.    IRIS4D      IRIS4D series computer
  89.    KERMIT      MS-DOS Kermit Tektronix 4010 emulator
  90.    LATEX       LaTeX picture environment
  91.    MF          Metafont Format
  92.    MIF         FrameMaker MIF 3.00 Format
  93.    NEC         NEC CP6 pinwriter printer
  94.    NEXT        NeXTStep Window System (only grey scale)
  95.    OS2PM       OS/2 Presentation Manager
  96.    PBM         PBMPLUS pbm, pgm, ppm formats
  97.    PCL         HP PCL5 (actually  HPGL/2)
  98.    POSTSCRIPT  PostScript
  99.    PRESCRIBE   Kyocera Laser printer
  100.    PSLATEX     Postscript graphics, LaTeX labels and titles
  101.    PSTRICKS    PSTRICKS 0.91 format
  102.    QMS         QMS/QUIC laserprinter (Talaris 1200 and others)
  103.    REGIS       ReGis graphics (vt125, vt220, vt240, Gigis...)
  104.    RGIP        Redwood Graphics Interface Protocol
  105.    SELANAR     Selanar
  106.    STARC       Star Color Printer
  107.    SUN         Sun Microsystems Workstation
  108.    T410X       Tektronix 4106, 4107, 4109 and 420x terminals
  109.    TANDY60     Tandy DMP-130 series 60-dot per inch graphics
  110.    TEK         Tektronix 4010, and probably others
  111.    TEXDRAW     TeXDraw format (for LaTeX)
  112.    TGIF        TGIF X11 Drawing Tool
  113.    TPIC        Tpic specials for TeX
  114.    UNIXPC      unixpc (ATT 3b1 or ATT 7300)
  115.    UNIXPLOT    unixplot
  116.    V384        Vectrix 384 and tandy color printer
  117.    VTTEK       VT like Tektronix 4010 emulator
  118.    X11         X11R4 window system
  119.  
  120.  
  121. These #defines are defined automatically by various compilers, some
  122. gnuplot routines check these defines to implement features found in the
  123. various environments:
  124.  
  125. define        note
  126. ------        --------
  127. AMIGA_AC_5    defined for Manx Aztec C 5.2a on the Amiga
  128. AMIGA_SC_6_1  defined for SAS/C 6.1 on the Amiga
  129. apollo        defined by Apollo's C compilers.
  130. _CRAY         defined by CRAY's C compiler.
  131. __TURBOC__    defined automatically by  Borland C++ 3.x
  132. unix          defined by most unix C compilers.
  133. vms           (and VMS) defined by VAX-11 C under VMS.
  134. __ZTC__       Zortech C compiler under MSDOS.
  135. _Windows      defined by Borland C++ 3.0 compiling for MS-Windows
  136.  
  137.  
  138.                              TO COMPILE
  139.  
  140. under UNIX:
  141. To compile do:
  142.   Copy makefile.unx to Makefile
  143.       cp makefile.unx Makefile
  144.   Look through the Makefile to see if you need to make any changes.
  145.   See especially the HELPDEST and TERMFLAGS variables.  Edit if needed.
  146.   Alternatively, all these variables may be set as command line arguments to
  147.   'make'. For example:
  148.  
  149.         make <MACHINE> HELPDEST='/usr/um/misc/lib/gnuplot.gih' \
  150.                 DEST='/usr/um/misc/bin' READLINE=
  151.  
  152.   Edit term.h, to include/exclude terminals
  153.   Type
  154.       make
  155.   For further instructions.
  156.   If that works, try
  157.       make install
  158.   For further instructions.
  159.  
  160. under VMS:
  161.   To compile:
  162.      copy makefile.vms makefile.
  163.      make
  164.   Or if you don't have a suitable make:
  165.      @buildvms
  166.   To tell gnuplot where to find the help library:
  167.       $ define gnuplot$help disk:[directory]gnuplot.hlb
  168.   Alternatively (and preferably) put the help in the main system help library.
  169.  
  170. under AmigaDOS:
  171. Using Aztec C 5.2a
  172.       make -f makefile.ami
  173. Using Lattice C 5.1
  174.       lmk -f makefile.amg
  175.  
  176. Using Microsoft C 7.0 and compiling for MS-Windows
  177.       copy makefile.msw makefile
  178.       nmake
  179.   Put wgnuplot.exe, wgnuplot.dll, wgnuplot.hlp and wgnuplot.mnu
  180.   in the windows directory.
  181.  
  182. under MSDOS:
  183. Using Microsoft C 7.0.
  184.       copy makefile.msc makefile
  185.       nmake 
  186.  
  187. Using Borland C++ 3.1 and compiling for MS-Windows
  188.       copy makefile.win makefile
  189.   Edit makefile to change TC.
  190.       make
  191.   Put wgnuplot.exe, wgnuplot.dll, wgnuplot.hlp and wgnuplot.mnu
  192.   in the windows directory.
  193.  
  194. Using Borland C++ 3.0
  195.       copy makefile.tc makefile
  196.   Edit makefile to change TC, BIN, BGI, BGIOBJ. You may also want to turn
  197.   off overlays (See manual for more on overlays).
  198.       make
  199.  
  200.  
  201. The file gnuplot.gih is needed for help on the PC.
  202. If the file gnuplot.gih is not in the default directory, then use:
  203.     set GNUHELP={full path name of gnuplot.gih}
  204.  
  205.  
  206.                          ENVIRONMENT VARIABLES
  207.  
  208. See 'help environment'.
  209.  
  210. If the environment variable GNUTERM is found, it is used as the terminal
  211. type. Otherwise, in some cases the variable TERM will be used, or the
  212. hardware may be automatically detected.
  213.  
  214. The PC version looks for the environment variable GNUPLOT to contain
  215. the name of the directory from which to load the initialization file
  216. GNUPLOT.INI.  See the help on 'start_up' for more information.
  217.  
  218. HOME is examined as a directory where a .gnuplot startup file might be
  219. found. See help on "start-up".
  220.  
  221. If defined, the environment variable GNUHELP is used for the name
  222. of the .gih help file, otherwise HELPFILE (defined in makefile or
  223. plot.c) is used.
  224.  
  225. The VMS version looks for the logical name GNUPLOT$HELP to locate
  226. the help library.
  227.  
  228. The CGI drivers need the CGIPATH environment variable to set the path
  229. to the CGI agents, and the CGIDISP and/or CGIPRNT environment
  230. variables to set the output devices.
  231.  
  232. The CGI drivers need the CGIPATH environment variable to set the path
  233. to the CGI agents, and the CGIDISP and/or CGIPRNT environment
  234. variables to set the output devices.
  235.